Release 10.1A: OpenEdge Development:
Progress 4GL Reference

BUTTON widget

A button widget represents a push button on the screen. The button can contain a textual label or it can have images associated with its pressed and unpressed states. You can define a static button with the DEFINE BUTTON statement. You can create dynamic buttons with the CREATE widget statement. This figure shows three buttons:

Attributes

AUTO-END-KEY attribute	AUTO-GO attribute	AUTO-RESIZE attribute
BGCOLOR attribute3	COLUMN attribute	CONTEXT-HELP-ID attribute3,5
CONVERT-3D-COLORS attribute3,5	DCOLOR attribute4	DEFAULT attribute2
DROP-TARGET attribute	DYNAMIC attribute1	FGCOLOR attribute3
FLAT-BUTTON attribute5	FONT attribute3	FRAME attribute
FRAME-COL attribute1	FRAME-NAME attribute1	FRAME-ROW attribute1
FRAME-X attribute1	FRAME-Y attribute1	HANDLE attribute1
HEIGHT-CHARS attribute	HEIGHT-PIXELS attribute	HELP attribute
HIDDEN attribute	HTML-CHARSET attribute1,5	IMAGE attribute
IMAGE-DOWN attribute	IMAGE-INSENSITIVE attribute	IMAGE-UP attribute
LABEL attribute	MANUAL-HIGHLIGHT attribute3	MENU-KEY attribute
MENU-MOUSE attribute4	MOUSE-POINTER attribute	MOVABLE attribute3
NAME attribute	NEXT-SIBLING attribute1	NEXT-TAB-ITEM attribute1
NO-FOCUS attribute2,3,5	NUM-DROPPED-FILES attribute1	PARENT attribute
PFCOLOR attribute4	POPUP-MENU attribute	PREV-SIBLING attribute1
PREV-TAB-ITEM attribute1	PRIVATE-DATA attribute	RESIZABLE attribute3
ROW attribute	SELECTABLE attribute3	SELECTED attribute
SENSITIVE attribute	TAB-POSITION attribute1	TAB-STOP attribute
TOOLTIP attribute3,5	TYPE attribute1	VISIBLE attribute
WIDGET-ID attribute 3,5	WIDTH-CHARS attribute	WIDTH-PIXELS attribute
WINDOW attribute1	X attribute	Y attribute
Readable only. Can be set only before the button widget is realized. Graphical interfaces only. Character interfaces only. Windows only.

Methods

END-FILE-DROP( ) method	GET-DROPPED-FILE( ) method
LOAD-IMAGE( ) method	LOAD-IMAGE-DOWN( ) method
LOAD-IMAGE-INSENSITIVE( ) method	LOAD-IMAGE-UP( ) method
LOAD-MOUSE-POINTER( ) method	MOVE-AFTER-TAB-ITEM( ) method
MOVE-BEFORE-TAB-ITEM( ) method	MOVE-TO-BOTTOM( ) method
MOVE-TO-TOP( ) method

Events

Default keyboard events	Developer events
Mouse events	Navigation key function events
Universal key function events	CHOOSE
DROP-FILE-NOTIFY	ENTRY
LEAVE

See also

The chapter on buttons, images, and rectangles in OpenEdge Development: Progress 4GL Handbook .